Skip to content

Refresh README, docs, and YouTube integration#1153

Merged
sbryngelson merged 27 commits intoMFlowCode:masterfrom
sbryngelson:read-improvements
Feb 17, 2026
Merged

Refresh README, docs, and YouTube integration#1153
sbryngelson merged 27 commits intoMFlowCode:masterfrom
sbryngelson:read-improvements

Conversation

@sbryngelson
Copy link
Member

@sbryngelson sbryngelson commented Feb 17, 2026

Summary

  • README overhaul: hero video, Gordon Bell headline, "Why MFC" and "Try MFC" sections, badge cleanup, YouTube badge
  • Scaling plots: combined El Capitan/Frontier/Alps plot with dark-mode variant
  • Docs landing page: SEO meta tags, YouTube nav link, Vimeo-to-YouTube links
  • Docs site: narrower sidebar, shorter Doxygen titles, remove footer bar and sync button
  • Badge fixes: remove stray %09 from shields.io URLs, fix "LLNL LC" phrasing

Test plan

  • ./mfc.sh precheck passes (all 5 checks)
  • Verify README renders correctly on GitHub (light and dark mode)
  • Verify docs site builds and nav links work
  • Confirm YouTube badge and docs YouTube link point to correct channel

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Documentation

    • Updated project description to reflect focus on exascale capabilities
    • Refined documentation page headers and titles for clarity
    • Migrated featured simulations from Vimeo to YouTube sources
    • Corrected institution names in acknowledgments
  • Style

    • Enhanced website navigation layout and grid responsiveness
    • Simplified footer design and removed generator branding
    • Adjusted sidebar styling
  • Chores

    • Updated README badges with YouTube links

sbryngelson and others added 26 commits February 16, 2026 15:04
- Add tagline and hero blockquote (Gordon Bell, 200T grid points, exascale)
- Promote shock-droplet image to hero position
- Add "Why MFC?" section with 6 key differentiators
- Streamline "Try MFC" with direct Codespace link and first-simulation command
- Remove redundant Getting Started section (Codespaces detail, macOS from-source)
- Deduplicate citation block and star CTA (each appeared twice)
- Move star history chart to bottom
- Fix 3 broken doc links: md_examples, md_running, md_getting-started

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…caling plot

Add 2025 Gordon Bell Prize Finalist tagline to hero section, OpenGraph
and Twitter Card meta tags for link sharing, GitHub stars badge, updated
SEO meta description, and replace Frontier+Summit scaling plots with a
single three-machine weak scaling figure (El Capitan, Frontier, Alps).
Fix LLNL typo and add El Capitan to compute resources footer.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Add alt attributes to all badge <img> tags for accessibility (MD045).
Normalize GPU scaling sub-list indentation from mixed tabs/spaces to
consistent 4-space indent.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
logo2.png does not exist in docs/res/, causing broken social previews.
Use banner.png which is a known-good asset.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Added a link to GitHub assets in the README.
Remove the static shockdrop.png in favor of the embedded shedding
water droplet simulation video, which auto-plays and loops on GitHub.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Updated link to the largest known public CFD simulation.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Replace per-system Frontier SVG with new combined GPU weak scaling
PNG covering El Capitan (MI300A), Frontier (MI250X), and Alps (GH200).
Mark Summit-era sections as historical. Fix typos.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Use <div> instead of <p> for proper centering of video element.
Add controls attribute as fallback when autoplay is blocked.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Update "Is this really exascale?" with combined El Capitan/Frontier/Alps
weak scaling plot. Remove Discussions badge since Discussions is disabled.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Generate inverted-grayscale dark variant of weak scaling plot while
preserving colored data points. Use <picture> element for automatic
light/dark mode switching, matching the star history chart pattern.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
The Doxygen docs site uses a dark theme, so the dark variant of the
weak scaling plot matches better.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Fix outdated 'init' subcommand references to 'new' in the Toolchain
table and tab completion note. Remove duplicate shock-droplet run
command and visualization text already covered in Try MFC section.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Remove stray %09 (encoded tab) from shields.io badge color params
- Use light scaling plot in docs (works in both themes)
- Fix "LLNL LC" to "LLNL" in docs footer

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@coderabbitai
Copy link
Contributor

coderabbitai bot commented Feb 17, 2026

Caution

Review failed

The pull request is closed.

📝 Walkthrough

Walkthrough

Documentation and UI updates including badge URL fixes, project brief text changes, CSS styling for navigation sidebar, footer simplification, video source migrations from Vimeo to YouTube, navigation grid expansion, and documentation generation header text refinements.

Changes

Cohort / File(s) Summary
Documentation Badges and References
README.md
Fixed trailing encoded tab markers in Tests and Contributors badges; added YouTube badge links in header and miscellaneous badge sections.
Documentation Configuration and Styling
docs/Doxyfile.in, docs/custom.css, docs/footer.html
Updated project brief from "High-fidelity multiphase flow simulation" to "Exascale flow solver"; added CSS rules to narrow sidebar navigation and hide tree sync button; removed footer blocks including nav-path and doxygen branding.
Documentation Content
docs/index.html
Migrated featured simulation video sources from Vimeo to YouTube; updated navigation grid from 4 to 6 columns; removed GitHub stars shield image; corrected institution name from "LLNL LC El Capitan" to "LLNL El Capitan".
Documentation Generation Scripts
toolchain/mfc/cli/docs_gen.py, toolchain/mfc/params/generators/docs_gen.py
Updated documentation headers: "Command Line Reference" → "CLI Reference" and removed "Reference" suffix from "Case Parameters Reference" and similar headings.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

Suggested labels

Review effort 2/5, size:M

Poem

🐰 Hop along as badges shine anew,
YouTube links replace the Vimeo view,
Sidebars narrow, footers fade away,
"CLI Reference" dances in the display,
Documentation blooms in cleaner style today! ✨

✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@codecov
Copy link

codecov bot commented Feb 17, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 44.07%. Comparing base (4c52155) to head (29dad77).
⚠️ Report is 5 commits behind head on master.

Additional details and impacted files
@@           Coverage Diff           @@
##           master    #1153   +/-   ##
=======================================
  Coverage   44.07%   44.07%           
=======================================
  Files          70       70           
  Lines       20431    20431           
  Branches     1974     1974           
=======================================
  Hits         9004     9004           
  Misses      10291    10291           
  Partials     1136     1136           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@sbryngelson sbryngelson marked this pull request as ready for review February 17, 2026 11:21
Copilot AI review requested due to automatic review settings February 17, 2026 11:21
@sbryngelson sbryngelson merged commit 9b1e64f into MFlowCode:master Feb 17, 2026
36 of 41 checks passed
Copy link
Contributor

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

1 issue found across 7 files

Confidence score: 4/5

  • Minor security hardening opportunity: docs/index.html adds a target="_blank" link without rel="noopener noreferrer", which could allow window.opener control.
  • Overall risk is low because the issue is localized to docs and easy to remediate before or after merge.
  • Pay close attention to docs/index.html - add rel="noopener noreferrer" on the new external link.
Prompt for AI agents (all issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="docs/index.html">

<violation number="1" location="docs/index.html:158">
P2: Add rel="noopener noreferrer" on the new target="_blank" link to prevent the opened page from controlling window.opener.</violation>
</file>

Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.

<i class="pr-4 fa-solid fa-newspaper"></i>
<span class="flex-1">Papers</span>
</a>
<a class="px-4 flex flex-row items-center py-4 border-b-2 hover:border-amber-400" href="https://www.youtube.com/@MFCode" target="_blank">
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2: Add rel="noopener noreferrer" on the new target="_blank" link to prevent the opened page from controlling window.opener.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At docs/index.html, line 158:

<comment>Add rel="noopener noreferrer" on the new target="_blank" link to prevent the opened page from controlling window.opener.</comment>

<file context>
@@ -156,6 +155,10 @@
                         <i class="pr-4 fa-solid fa-newspaper"></i>
                         <span class="flex-1">Papers</span>
                     </a>
+                    <a class="px-4 flex flex-row items-center py-4 border-b-2 hover:border-amber-400" href="https://www.youtube.com/@MFCode" target="_blank">
+                        <i class="pr-4 fa-brands fa-youtube"></i>
+                        <span class="flex-1">YouTube</span>
</file context>
Suggested change
<a class="px-4 flex flex-row items-center py-4 border-b-2 hover:border-amber-400" href="https://www.youtube.com/@MFCode" target="_blank">
<a class="px-4 flex flex-row items-center py-4 border-b-2 hover:border-amber-400" href="https://www.youtube.com/@MFCode" target="_blank" rel="noopener noreferrer">

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR refreshes the project’s public-facing documentation (GitHub README + Doxygen site) and swaps website video links to YouTube, while also tightening up Doxygen page titles and layout.

Changes:

  • Shorten Doxygen-generated page titles/headers (“Case Parameters”, “CLI Reference”).
  • Update docs landing page: Vimeo → YouTube links, add a YouTube nav item, adjust top-link grid, and tweak sponsor/system wording.
  • Doxygen UI tweaks: narrower sidebar, hide nav sync button, and remove the default footer bar.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
toolchain/mfc/params/generators/docs_gen.py Shortens parameter docs page title and the CLI section header wording.
toolchain/mfc/cli/docs_gen.py Renames the generated CLI reference page title/header to “CLI Reference”.
docs/index.html Replaces video sources with YouTube links; adds YouTube nav link; adjusts layout text/grid.
docs/footer.html Removes the generated footer/navpath output from Doxygen pages.
docs/custom.css Sets a narrower side-nav width and hides the tree sync button.
docs/Doxyfile.in Updates the Doxygen project brief to a shorter tagline.
README.md Fixes badge URL encoding issues and adds a YouTube badge/link.

<i class="pr-4 fa-solid fa-newspaper"></i>
<span class="flex-1">Papers</span>
</a>
<a class="px-4 flex flex-row items-center py-4 border-b-2 hover:border-amber-400" href="https://www.youtube.com/@MFCode" target="_blank">
Copy link

Copilot AI Feb 17, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Links that open in a new tab/window should include rel="noopener noreferrer" to prevent reverse-tabnabbing and avoid leaking window.opener. Add the rel attribute alongside target="_blank" here.

Suggested change
<a class="px-4 flex flex-row items-center py-4 border-b-2 hover:border-amber-400" href="https://www.youtube.com/@MFCode" target="_blank">
<a class="px-4 flex flex-row items-center py-4 border-b-2 hover:border-amber-400" href="https://www.youtube.com/@MFCode" target="_blank" rel="noopener noreferrer">

Copilot uses AI. Check for mistakes.
Comment on lines +43 to +45
<a href="https://www.youtube.com/@MFCode" target="_blank">
<img src="https://img.shields.io/badge/YouTube-MFlowCode-red?logo=youtube&style=flat" alt="YouTube"/>
</a>
Copy link

Copilot AI Feb 17, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This new external link uses target="_blank" but is missing rel="noopener noreferrer", which is recommended to prevent reverse-tabnabbing via window.opener. Add the rel attribute for this anchor (and ideally keep it consistent with other target="_blank" links in the README).

Copilot uses AI. Check for mistakes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

Comments